Cream of the Crop 26

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 26 / Cream of the Crop 26.iso / utility / oh21.zip / OH.DOC < prev next >

Wrap

Text File | 1997-06-21 | 50KB | 918 lines

Orchard House Copyr. 1995 - 1997 Gleason Pace China Wing Software 12162 S. W. Scholls Ferry Rd. #191 Tigard, Or. 97223 CONTENTS Disclaimer of Warranty........................3 Requirements..................................4 Program Overview..............................5 Using Orchard House...........................6 When you load OH............................6 Command Mode................................6 Full Screen Edit Mode.......................7 Config File.................................9 Other Orchard House Features.................10 Typical OH Command Mode display..............11 Overview of OH function keys.................12 Edit Mode keys list........................12 Command Mode keys list.....................13 Cursor/Highlight Bar control.............13 Feature control..........................14 Color control............................15 OH function keys in detail...................16 Edit Mode keys.............................16 Command Mode keys..........................17 Feature control..........................17 F2............(edit command line)......17 F3/F4/F5......(change list)............17 F6............(display next page)......17 Shift-F6......(display from start).....17 F7............(create new directory)...17 F8............(mark file or dir).......18 F9............(do internal DOS comd)...18 F10...........(change default drive)...18 F11...........(display archived lists).18 F12...........(display previous page)..18 Alt-Enter (Change Dir & execute)...19 Cntrl-Enter...(Change Dir only)........19 Delete........(delete file/directory)..19 Enter.........(universal action key)...20 Num+..........(move up directory)......21 Alt-Num+......(move to root)...........21 Num-..........(silence beep)...........21 Scroll-Lock...(preserve lists).........21 0-9...........(run Autokey program)....21 . or >........(raise file attribute)...22 , or <........(lower file attribute)...22 a or A........(archive lists)..........22 c or C........(copy file/directory)....23 d or D........(exit to DOS)............24 g or G........(mark list entries)......24 m or M........(move file/directory)....24 o or O........(overview OH status).....24 p or P........(purge directories)......24 q or Q........(query file/directory)...24 t or T........(set time)...............24 u or U........(unmark list entries)....25 x or X........(enter Full Screen edit).25 y or Y........(set date)...............26 Color control............................26 History......................................27 Terms of Distribution........................28 Contact info.................................28 3 DISCLAIMER OF WARRANTY I have spent a good deal of time making Orchard House the best of its kind; however, this software and documentation file are provided "As Is" and without warranties as to performance or merchantability or any other warranties whether expressed or implied. Because of the various hardware and software environments into which this program might be put, no warranty of fitness for a particular purpose is offered. Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. Any liability of the seller will be limited exclusively to product replacement or refund of purchase price. The copyrighted or registered names mentioned herein are the property of their respective owners. The files you should find in this archive are: OH.EXE--Orchard House. OH.DOC--this file. REGISTER.FRM--How to register Orchard House. 4 Requirements DOS 5.0 or higher. Compatible with Hercules, monochrome, CGA, EGA, VGA video systems. OH will run on any IBM compatible 386+ system including networks. OH only requires 50K for itself, but it also requires access to 64k of extended memory. Orchard House detects the presence of and releases time slices to DOS sessions under OS2, Desqview and Windows. If Windows is holding back on giving OH time, try setting IdleVmWakeUpTime=x (with x being 1 or 2 seconds) in system.ini. If you are using a real IBM or MS DOS in the window, rather than an OS2 or Windows virtual DOS, you will need to have at least DOS 5.0 to get time slice support. 5 Program Overview Orchard House is a very quick and handy DOS shell that does everything you always wished a shell would do without getting in your way. It allows you to assign up to 10 file/program names to hot keys 0-9 and provides automatic passing of parameters. Previous commands are always on display and accessible in various formats with just a few keystrokes, and they can be edited with full keyboard cursor control giving you truly managed command line support. Any program or batch file will run in the OH environment with piping or redirection if desired. Generally, the intention of this program is to simplify and combine DOS processes. For instance, multiple directory levels can be created or deleted all at once. And it is not necessary to thread though menus to find the function you need. I have put a lot of work into this documentation knowing full well that, if you can't get OH to do what you want after a few tries, you probably won't use it. Docs pretty much go unread. There is just too much good stuff out there to hassle with a program that doesn't work right with a small amount of effort. On the other hand, OH, because of its small size, is deceptive. This program does a LOT. And it does it quickly and easily. A little noticing of the different modes that this program can operate in and considering how these modes fit into your needs and patterns will pay off. 'Nuff said. The OH Function Keys in Detail section is provided as a reference in case you are having a specific problem with a specific function. I use OH constantly. It has been a great help to me over the past few years. And developing it has been a great source of enjoyment. May it be useful for you as it has been for me. 6 USING ORCHARD HOUSE When you load OH it is prepared to act in six different ways: ■ OH presents editable menus of directories to change to, programs to run and data files to edit. It loads and sorts the default directory content and displays it in three separate lists. You will have room for 900-1000 entries in the Program File List, 900-1000 in the Data File List, and approximately 600-700 in the Directory List. ■ These lists also directly become editable menus of files and directories to move, copy or delete. ■ The lists can be displayed in two different formats (operational modes) with special powers given to each. ■ OH provides a list of 10 Autokey programs which can be executed by pressing 0-9. The information at the flashing prompt in the lists will be passed to the program as a command line if the program will accept one. ■ OH stores commands as they are executed in the History Lists. Previous commands also remain in the list of origin and can be edited and/or used again from either location. ■ OH accepts "Enter" as an all purpose command execution key. Place the cursor on the directory you wish to change to, command line you wish to execute, or data file you wish to read and press this key. OH expects directory names to be in the Directory List. Otherwise, OH uses the file extension to determine what action to take. 7 OH has two operational modes each with submodes. ■ Command Mode: presents you with three sorted lists (Directory List, Program File List, and Data File List) plus the 10 member Autokey List. The entries in the lists are shown in abbreviated form. Any of them can be individually edited. All of OH's functions are available in this mode. Use "scroll lock" to switch between submodes: ■ Overwrite lists when changing default drive or directory. This is the default mode when loading OH. ■ Preserve lists when changing default drive or directory. You can load OH in this mode if you start with scroll lock on. If you have previously saved a set of lists with the "a" function and use the "/s" switch, OH will display these lists at startup. ■ Full Screen Edit Mode: presents you with a full screen, text editor style display of one of the lists. You have complete freedom of cursor movement, allowing you to edit, and/or execute any of the command lines shown. You may also switch between the three lists of the current submode. A limited set of function keys is available. You can load OH in this mode if you use the "/x" switch. You can enter Full Screen Edit Mode from Command Mode by 8 pressing the "x" key. Once you are in Full Screen mode, use "Page Down" to switch submodes: ■ Command History Lists: when you execute commands in one of the other modes, the commands are saved to these lists as well as preserved in the list of origin. The history lists are never overwritten with directory information. ■ Directory Content Lists: the same lists you see in Command Mode but with Full Screen edit access. When you execute a command in this submode, you will find the list shifted up one line when you return to OH. The cursor will be placed at a new blank line just as it would be if you were executing commands at the DOS prompt. Some sample OH command lines: OH loads OH in Command Mode. OH /s loads OH in Command Mode using lists previously saved with the "a" function. OH /x loads OH in Full Screen Edit Mode, History List submode. OH /s,/x loads OH in Full Screen Edit Mode, Directory Content List submode, using lists previously saved with the "a" function. Also the Autokey List can be loaded from the command line as described below. Be sure to use lower case for switches and a comma to separate parameters. 9 OH creates an editable config file called OHINFO.%$% once it has been run. OH will look for the file in the directory where it finds itself and will create a new config file if it is not there. The format is: lines 1-30 (a)rchived Executable List 31-60 (a)rchived Data File List 61-90 (a)rchived Subdirectory List 91-110 Executable History List 111-130 Data File History List 131-150 Subdirectory History List 151-160 Autokey list I have attempted to make the file self correcting, so you are fairly free to edit it as you wish. Line lengths are not critical, and almost any plain ascii editor should do. However, no provision is made for comments or line numbers, entries made in a particular line will be displayed in a particular place. Lines 91-160 are saved each time you exit OH, so, if you want to edit them directly, you will not want to run your editor inside OH. It is actually easier to make the changes you want for these entries in OH itself while it is running. They will be automatically saved when you exit. The (a)rchived entries refer to lists saved with the "a" feature. These are saved only when you invoke the feature by pressing "a" in command mode. Autokey file names typed in OH's own command line or present in a batch file command line for OH will take precedence over config file entries and will be saved to the config file next time you exit OH. 10 Other Orchard House Features ■ File and directory copy, move and delete operations can be from anywhere and to anywhere. ■ File and directory attributes are displayed and file attributes can be very easily changed. ■ If any part of the target path does not exist in a file copy, or move, OH will ask if you want to create the new directori(es) needed and, if so, create them. OH creates new directories needed for directory moves without asking. ■ OH creates multiple new directory levels all at once rather than one level at a time. ■ OH provides a directory prune function which will scan the directory tree starting at the level named at the flashing cursor/highlight bar, and remove all empty directories. If the named directory becomes empty in this process, it too will be deleted. A separate feature for deletion of directories that are not empty is also provided. ■ OH will avoid copying files onto themselves and will ask if you want to overwrite duplicate file names. ■ OH uses the faster DOS rename function for file move operations whenever possible. ■ Improved interrupt 24 (drive not ready, etc.) handler providing meaningful options that work the first time. ■ Date and time set and display. ■ 16 color selection for 7 areas of the display if your system supports this. Default colors (B/W) can be restored. Your favorite screen color scheme can be saved. OH will load with it in the future. 11 Typical OH Command Mode display * DIRECTORY LIST AREA * Monday, September 21, 1992▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒05:50PM ▒▒▒ Autokey Programs ▒▒▒▒▒ASMFILES ▒▒ ▒▓▓ 1. ds 6. cad.bat ▒▒▒▓▓ ▒▒ ▒▓▓ 2. edit 7. sr ▒▒▒▓▓ ▒▒ ▒▓▓ 3. ff 8. ▒▒▒▓▓ ▒▒ ▒▓▓ 4. m.bat 9. ▒▒▒▓▓ ▒▒ ▒▓▓ 5. a.bat 0. ▒▒▒▓▓ ▒▒ ▒▓▓ ▒▒▒▓▓ ▒▒ ▒▓▓ * STATUS BOX * ▒▒▒▓▓ ▒▒ ▒▓▓ Subdirectory List 1/1 ▒▒▒▓▓ ▒▒ ▒▓▓ Free disk space: 10182656 b ▒▒▒▓▓ ▒▒ ▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒ ▒▒▒C:\BIN\ASMFILES * COMMAND LINE EDIT AREA * f1=help ▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒[C:\MASM\BINP]▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ▒▒▒CATCH.TXT 1 KEYS.LIS ▒▒▒▒▒CALLTREE.E LIB.EXE ▒▒ ▒▓▓CV.HLP M.TMP ▒▒▒▓▓CREF.EXE LINK.EXE ▒▒ ▒▓▓FACE.ASM MACRO.ASM ▒▒▒▓▓CV.EXE M.EXE ▒▒ ▒▓▓FACE.BAK MEMO ▒▒▒▓▓CVPACK.EXE MAKE.EXE ▒▒ ▒▓▓FACEIMPR.B PACK.LIB ▒▒▒▓▓ECH.EXE MASM.EXE ▒▒ ▒▓▓FACEIMPR.T PACK.LIS ▒▒▒▓▓ERROUT.EXE MEGREP.EXE ▒▒ ▒▓▓GUF TOOLS.INI ▒▒▒▓▓EXEHDR.EXE MEM.BAT ▒▒ ▒▓▓HN.ASM ▒▒▒▓▓EXEMOD.EXE SCED.COM ▒▒ ▒▓▓KACE.OBJ ▒▒▒▓▓EXEPACK.EX UNDEL.EXE ▒▒ ▒▓▓KCED.ASM ▒▒▒▓▓EXP.EXE VIDTST.EXE ▒▒ ▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓cns▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒ * DATA FILE LIST AREA * * PROGRAM FILE LIST AREA * Information between asterisks and arrows (* *) are labels for this illustration and do not appear in the actual display. Also the "Subdirectory List" entry in the status box indicates that the flashing cursor/highlight bar would be in the Directory List Area (but I can't show the highlight bar in this text file). Specifically, "ASMFILES" in that list would be highlighted linking to the display in the command line edit area. The "1/1" in the status box indicates that there is only one entry in this list and that the entire list has been displayed. The (completed) display in the command line edit area changes as you move the (abbreviated) highlight bar. The "1" next to "catch.txt" indicates that the read only file attribute has been set for this file. The "" next to "keys.lis" means that this entry in the data file list has been marked for multiple copy or move operations. 12 OVERVIEW OF OH FUNCTION KEYS Edit Mode Keys List Arrow Move the cursor left or right and, in Full Screen mode, up and down. Bksp Delete the previous letter. Del Delete the letter under cursor. End Move the cursor to the end of the line. Enter Universal action key that terminates input and initiates action. Esc Exit edit mode. Home Move the cursor to the beginning of the line. Ins Toggle insert mode. Page down In Full Screen Mode, switch between the History List and the Directory Content List displays. Page up Erase to the end of the line. Tab Move the cursor to the next blank space. 13 Command Mode Keys List Cursor/Highlight Bar Control Arrow Move the highlight bar among the selections in the lists. Wrap around in all directions is provided. Center Same as Insert. End Move the highlight bar to the lower left of the current list. Home Move the highlight bar to the upper left of the current list. Insert Move the highlight bar to the center of the current list. Page down Move the highlight bar to the lower right of the current list. Page up Move the highlight bar to the upper right of the current list. 14 Feature Control F1 Context sensitive help. F2 Edit the entry at the flashing cursor/highlight bar. F3 Move cursor to Directory List. F4 Move cursor to Program File List. F5 Move cursor to Data File List. F6 Display the next page of the current list. Shift-F6 Reload and display the current list from the beginning. F7 Create new directori(es). F8 Mark file or directory at cursor. F9 Run DOS internal command. F10 Enter change default drive procedure. F11 Replace current list display with lists previously saved with the "a" feature. F12 Display previous page of the current list. Del Delete files or directories at the cursor or marks. Alt-Enter Same as Enter, except that OH changes the default directory to the path of the program or data file as well as execute it or load it into an editor. Cntrl-Enter Changes the default directory to the path of the program or data file without executing or loading it. Enter Universal action key that runs a program, changes default directory or loads a data file into an editor. Esc Terminate OH and returns to DOS. Num+ Move the default directory up one level. Alt-Num+ Move the default directory to the root. Num- Toggle error beep. Scroll lock Toggle automatic overwriting of lists when default drive or directory is changed. 1,2,3, Start the respective Autokey Program 4,5,6, passing the data file at the cursor as the 7,8,9,0 file for the Autokey Program to act on. Pressing shift and the number allows you to edit the Autokey Program entry. . or > Increase attribute sum for a file. , or < Decrease attribute sum for a file. a or A Archive the current lists to disk so OH can be loaded with them in place next time. c or C Copy files or directories at the cursor or marks. d or D Provide direct Dos access. Type 'exit' to return to OH. g or G Mark all valid filenames or directories in the current list. m or M Move the files or directories at the cursor or marks. o or O Overview Orchard House Status. q or Q Query info about a file or directory. t or T Set the computer clock. u or U Unmark all marked entries in the current list. x or X Enter extended edit mode. y or Y Set the computer calendar 15 Color Control ` or ~ Toggle background bright color blink. b or B Change the border color. e or E Change the empty space color. h or H Change the highlight color. This is the color of the list cursor and the status box above the center edit line. i or I Change the information color. This is the color of the Autokey List in the upper left corner of the display and the help screen text. l or L Change the list color. This is the color of the three Directory Content Lists. n or N Change the color of OH help prompts and the help screen border. r or R Restore startup default colors. The default colors are black and white. s or S Change the color of selected drive for the change default drive function (f10). v or V Save your color selections so OH can be loaded with them next time. 16 OH FUNCTION KEYS IN DETAIL Edit Mode Keys Edit Mode includes editing command lines, and date, time, or color input fields. The arrow keys provide cursor movement with left and right wrap around. "Home" and "End" move the cursor to the beginning or end of text entered. "Backspace" and "Delete" erase single characters and "Page Up" erases from the current cursor position to the end of the input space. "Insert " toggles whether entered text will appear over old text or push old text to the right. "Enter" exits Single Line Edit (but not Extended Edit Mode) and executes the action as indicated; "escape" exits Edit Mode with no action. See the discussion of the "Enter" key in the next section for a more complete description of its operation. Of the Command Mode functions, only "Num-", "Num+", "Alt-Num+", "Scroll lock" and the "f(n)" keys are available. 17 Command Mode Keys Feature Control F2: Enter Single Line Edit mode and allow editing of the command line that is currently displayed across the center of the screen. The keys mentioned in the "Edit Mode Keys List" function here. For further discussion of Edit Mode see the paragraph above. F3, F4, F5: These keys move the cursor among the list areas. The cursor maintains its relative position within that list. In Full Screen edit mode, the appropriate list displayed. F6: Display the next page of the current list from the cursor position to the end of available space. OH keeps track of files or directories listed so far and starts over when all have been displayed. Shift-F6 will reload directory contents and restart display at the top of the list. F7: Make a new directory. This function operates in any of the three lists. If you include drive and path, the directory is created as specified. If you omit drive and path, the subdirectory is created in the current default directory. You can create multiple directory levels all at once. For instance: you can create "C:\WP\DOCS\JOHN\PROJ#1" from anywhere simply by pressing "f7", typing the appropriate information and pressing "Return." 18 F8: Mark the file or directory at the cursor. Marked files or directories can be copied, moved or deleted as a group. If the operation specified is unsuccessful for any reason, the files or directories not copied, moved or deleted remain marked after OH returns control to you. The mark is removed for any files that have been successfully operated on. OH also displays the total disk space of the files marked. F9: Run an internal DOS command within OH. When you press this key, if you are not already in Single Line Edit mode, the cursor moves to the central command line edit area or, in Full Screen Edit Mode, remains at the currently selected command line. OH then waits for you to enter a DOS internal command. Press "Enter" to execute the command, or "Escape" to abort the operation. Internal DOS command lines that you have executed are not saved for reuse. The DOS internal command "DIR" can be entered in the lists and executed like any external command. F10: Change the default drive. A list of available drives is displayed. The number of available drives can be controlled by putting a LASTDRIVE command in your config.sys file. Left and right cursor movement with wrap around is allowed within the list. The "Home" and "End" keys are active as in edit mode. Press enter when the highlight is on the drive you want, or you can simply press the letter of the drive you want at any time in this display. As you move the cursor from letter to letter in the list of available drives, the default directory contents for each drive will be displayed in the three list areas if "Scroll Lock" is turned off. F11: Display lists previously saved using the "a" function. You will need to exit OH and reenter to be able to access the lists after using the "a" function. F12: Like F6, except that it displays the previous page of the current list. 19 Alt-Enter: Same as Enter, except that OH changes the default directory to the path of the program or data file at the highlight bar as well as execute it or load it into an editor. It works the same as Enter in the Directory List. Cntrl-Enter: Changes the default directory to the path of the program or data file at the highlight bar without executing or loading it. It works the same as Enter in the Directory List. Delete: Delete the files or directories at the cursor or marks. If files or directories are marked in the list where you have placed the flashing cursor/highlight bar, these are deleted. Otherwise, the file or directory at the cursor is deleted. Data files or program files can be deleted in either the Data File List or the Program File List. Directories must be deleted from within the Directory List. If the directory you have indicated for deletion is not empty, OH will ask if you wish to go ahead before deleting. Any file or directory can be deleted from anywhere but you cannot delete the default directory or a parent of the default directory unless you are deleting an entire disk. To delete an entire disk: move the highlight bar into the Directory List press "F2" enter "A:\" (or whatever drive letter you wish) press Escape press Delete OH will stop and ask if you are sure you want to do this, but be careful with "C:\". OH really will delete your entire hard disk if you tell it to. Large operations like that can take a few minutes. 20 Enter: Pressing "Enter" with the cursor/highlight bar on a Directory List entry changes the default directory. The named subdirectory must be in the default directory or complete drive and path must be provided. If the new directory is on a different drive, OH will change the default drive as well. Pressing "Enter" with the cursor on an executable program or batch file name in the Program or Data File List (if no name conflict exists) will execute that program or batch file. The pertinent drive and directori(es) may be omitted if the program or batch file resides in DOS path or the default directory. The ".exe", ".com" or ".bat" extension also may be omitted. In cases of name conflicts, for instance if you have a data file named "reader" and a program named "reader.exe", OH will look for the data file if you call it from the Data File List, or the program file if you call it from the Program File List. Otherwise, pressing "Enter" with the highlight bar on a data file name in the Program (if no name conflict exists) or Data File List will load that file into any text editor named "edit" or "list". The drive and directori(es) may be omitted if the data file resides in the default directory. OH looks for "edit" first then for "list" (.exe,.com, or .bat). If none of those exist in the DOS path, OH will display the file with the DOS internal command "type" using the "more" pipe. Note that "type" will not be available under OS2, Windows or Desqview. If you do not have a text editor named "edit" or "list" and you do not wish to rename one (be sure to preserve the ".exe" or ".com" extension when renaming), you can make a batch file that calls your text editor and name it "edit.bat" or "list.bat". You will need to include the command line reference " %1" in your batch file after the program name. The pipe "more.com" comes with DOS and causes "type" to display text one page at a time. If you are using this option, "more.com" will need to reside in the DOS path. 21 Num+ key: Move the default directory up one level. For instance, if the current default directory is e:\bin\asmfiles, pressing "Num+" will cause the default directory to be set at e:\bin. Alt-Num+ will move the default directory to the root, e:\ in this example. Num- key: Toggle the error beep signal that is given when OH detects an error condition. The presence of the symbol "" in the key status bar in the bottom center of the screen tells you that the error beep is on. Scroll lock key: Toggle the Autolist feature. When this feature is selected (scroll lock is off), new Program, Data and Directory Lists are read and displayed from the default drive and directory when you move the cursor among the drive selection list (after pressing "f10") or otherwise change the default drive or directory. If the Autolist feature is not selected, no new information is read or displayed. This is useful if you want to change a default while preserving your command line lists for further use. If the "s" in the key status bar in the bottom center of the screen is lower case, "Scroll lock" is off. 1,2,3,4,5,6,7,8,9,0: Start the respective Autokey program or batch file passing the information at the flashing cursor/highlight bar, which can be in any of the three lists, to the program or batch file for action. The passed option line will normally contain a data file and/or option switches which, again, you can tailor to your needs in Edit Mode. Pressing shift and the number allows you to edit the Autokey Program entry. In other words to edit program 1, press shift and the number one (the equivalent of pressing "!"). All Edit Mode features will apply. When loading OH, you can give up to ten program or batch files on OH's own command line to pass to respective Autokey positions 0 through 9. They will be listed as Autokey Programs in the upper left corner of the OH display. Program or batch files for which you do not include drive or directory will need to be in the DOS path to run. You may omit the .exe, .com or .bat extensions. Including extensions, drive and directories speeds loading the program or batch file slightly. You may include data files in the Autokey declaration. OH will handle them as described for the "Enter" command above when the assigned number is pressed. Directory changes, however, cannot be accomplished with the Autokey List. All of OH's own command line entries must be separated by commas. For example, if you invoke OH as follows: OH c:\bin\m.exe,c:\fw3\fw,sm.exe,ts.doc pressing 1 will execute "m.exe", 2 will execute "fw.exe", "fw.com" or "fw.bat" and 3 will execute "sm.exe". In each case, OH will pass the information at the highlight bar as a command line to the program for its use. And finally, pressing 4 will load ts.doc to an editor named "edit", or "list" (.exe, .com or .bat) or pass it to the DOS "type" command. Once you have passed a set of file names on the command line, OH will save them in its config file so it will not be necessary to reenter them. OH will also save any changes you make while it is running. If you start OH from a batch file (or autoexec.bat) with file names on the command line, the command line entries will take precedence over the config file entries. 22 . or >: Increase attribute sum for a file. The attributes are displayed in sum form. The base indicators are: 1 - Read Only 2 - Hidden 4 - System So, if a file has a sum of 3, the read only and hidden attributes are set. Similarly, if the sum is 7, all three attributes are set. Directories may have any of the above attributes; OH will display but not change these. A directory with the 2, 4 or 6 attribute set may, however, be deleted. The same is true for a file. A file or directory with the 1 attribute set alone or in combination with other attributes may not be deleted without changing the attribute. OH does not affect or display the archive attribute. If you increase the sum past 7, it cycles to 0 (all attributes off). Similarly, if you decrease the sum below 0, it cycles to 7. , or <: Decrease attribute sum for a file. See above. a or A: Archive the current lists to disk so OH can be loaded with them in place next time. If you want to load OH with a previously archived set of lists, put a "/s" in the command line (without quotes) when loading OH. The "/s" (must be lower case) can be placed anywhere in the command line but it must be separated from any other entries by commas. If your system is configured to use some other switch character than the forward slash, go ahead and use your character. OH will recognize it. To use this feature, You should previously have archived your lists by pressing "a" or "A" while running OH, and OH should now have access to the config file created when you did that. Otherwise, OH will load with empty lists. The above OH command line including the "/s" switch would look like: OH c:\bin\m.exe,c:\fw3\fw,c:\util\sm.exe,ts.doc,/s 23 c or C: Copy the files or directories at the cursor or marks. If you are copying the file at the highlight bar, OH will enter Edit Mode and wait for you to give it drive, directory, and filename information for the new file. For multiple file/directory copies, you should enter only the destination; you may omit the final backslash if you wish. The destination drive and path can be anywhere, even a location that does not yet exist. Exit Edit Mode with "Escape" to abort the operation, or use the "Enter" key to complete it. If the destination you give does not exist, OH will stop and ask if you wish to create the new directories for file copies. For directory copies, OH automatically creates the needed directories without asking. You cannot change individual file names when copying multiple files. If a file in the process of being copied exists in the destination drive and directory, OH will ask if you wish to overwrite the file. If you do not, OH will ask you to enter a new name and/or destination for the file to be transferred. Entire drives may be copied by entering the drive indicator, semicolon and backslash in the Directory List as described for deleting above. Then press "c" (rather than "delete"). d or D: Pass control to DOS. Type "exit" to return to OH. g or G: Mark all the valid filenames or directories in the list where the cursor/highlight bar currently resides. Marks are not preserved through screen changes. For instance, all marks in a particular list are lost if you use "f6" to see its next page. m or M: Move the files or directories at the highlight bar or marks. This function operates in the same way as the copy routine described above, except that, if OH was successful in saving the file or directory at its new destination, OH will delete it from its old location. If the file or directory was not successfully saved at its new location OH will not delete the old file or directory. Wherever possible, OH uses the faster DOS rename function to move files. o or O Overview Orchard House Status gives you a display of a few of the parameters that OH keeps track of. p or P: Prune empty directories in the directory tree from the given starting point. If the top of the given tree becomes empty in the process, it too is deleted. t or T: Reset the computer clock. Input the time as HH MM SS. The blanks can be spaces, semicolons or any other key. Use military time, and press "Enter" when you are finished. The default is no change; invalid data will also give no change. 25 u or U: Unmark all files or directories in the list where the cursor/highlight bar currently resides. x or X: Enter Full Screen Edit Mode. Twenty entire command lines are displayed and complete freedom of cursor movement is allowed among them. Press "Page Down" to switch between the History Lists and the Directory Content Lists. Only the "f(n)", "Num-" and "Num+" and Alt-Num+ keys are active. Pressing "f3", "f4", or "f5" will display a different list for you but the old list is preserved and will be redisplayed if you press the appropriate "f(n)" key to bring it back. The "Enter" key operates as in other modes, executing a command, changing the directory or displaying a data file depending on the current list and the command line contents. When you return from executing a command line in this mode, you will find the command shifted up one line if you are not in History List submode. The cursor will be positioned on a blank line ready for new input. Press Escape to exit Full Screen Edit Mode and return to Command Mode. Relative cursor list position is maintained when switching to and from Full Screen Edit Mode for the first 20 Command Mode positions. Use the "/x" command line switch to load OH in this mode (History List submode). If you use both the "/x" and the "/s" command line switches, OH will load in the Directory List submode and display lists previously saved with the "a" function, if any. 26 y or Y: Reset the computer calendar. Input the date as MM DD YY. This function operates in the same way as the reset time routine described above. Color Control These functions operate in the same basic pattern. When one of them is invoked, a list of colors is displayed and you are asked to supply color codes in either a text/background, TT BB, format or as two digits, CC, depending on the function you have chosen. The space in the TT BB format can be a space or any other key. Codes for the present settings are displayed as defaults. The list of color choices in the upper right of the screen will be in two columns. Codes for the left column are 0 through 7; codes for the right column are 8 through 15. The colors in the left column are normal intensity and can be used for the either text or background. The right column has the high intensity (light) colors. If you choose a color from the right column for a background color it will display as normal intensity and blink. You can disable blinking and get high intensity background display by pressing "`" or "~". Blinking is disabled when you see the "" symbol displayed in the key status bar in the bottom center of the screen. When you have the colors the way you want them, press "v" or "V" to save them. OH will load with your color selections in place next time. 27 Changes in version 1.1 1. Extra sort routines kick in at 200 directory entries rather than 300. 2. Fixed bug in handling of alternate destinations for duplicate files. 3. F12 no longer resets display counter at end of list. 4. OH now correctly receives parameters passed by OS2 WPS. 5. The /x switch now correctly loads OH in history mode 6. Shift-f6 function added. Changes in version 1.2 1. Fixed bug in create new directory for file copy/move function. 2. Corrected sort behavior for odd length lists. 3. Fixed bug in vertical directory move function. 4. Center key (5 with numlock off) maps to insert key. 5. Added Alt-num+ function. 6. Color change prompts corrected. Changes in version 1.3 1. Query function added. 2. Improved detection of Windows. 3. Removed flashing from monochrome display. 4. Another correction of sort behavior of odd list lengths. 5. Greatly enlarged list capacities. 6. Fixed the load textfile autokey function. 7. OH now is able to handle directories with duplicate filenames. 8. Fixed problem that caused OH to sometimes put files without extension in the wrong list. 9. Added list and edit line position counters. 10. Added escape capability to the change drive function. 11. Added Interrupt 24 handling to archive function and notice if data file cannot be saved because of Interrupt 24 condition when exiting OH. 12. Added infinite loop sorting. OH will continue to sort directory contents until no more changes are found. Max I have seen is 3-4 seconds to sort 1000 entries. 13. Unmarking a marked file/directory now restores display of the attribute as appropriate. 14. Alt-num+ now works in Extended Edit Mode. Changes in version 1.3a 1. Prune function no longer works without a directory name to work on. 2. Scroll Lock (on) can now be use to prevent shifting the list up one line when executing a program in Full Screen Edit Mode, Directory Content List Submode. 3. Autokey programs now place a complete command line in History Lists. 4. Fixed bug causing lists to not display with Scroll Lock on. Changes in version 2.0 1. Added Escape key function to directory and multiple file operations. These operations may now be exited while in process. 2. OH now remembers which files and directories are marked while executing other functions. 3. Cleared up possible conflicts with data files named "dir", "edit", "list" and "type" without extension. 4. Duplicate entries in the History Lists are no longer saved. 5. Added Cntrl-Enter change directory feature. 6. Added Alt-Enter execute program and change directory feature. 7. Shift-F6 changed to Alt-F6. 8. Alt-F6 now available in Edit Mode. 9. Help screen is now available when making multiple directory or file copy/moves. 10. F7 prompts for input if highlighted list entry is blank. 11. File date, time and attribute is now preserved for all copy/move opperations. 12. Added "Overview Orchard House Status" function. Changes in version 2.1 1. Fixed severe bug in v 2.0 copy/move dir function. 2. Fixed cosmetic bug in change time display. 28 Orchard House is distributed as shareware and, as such, is provided for evaluation purposes only. If you find OH useful and wish to continue using it, you need to register. This also gets you updates and technical support. See the included file REGISTER.FRM for further information. For product information, technical support, or quotes on volume discounts, dealer pricing, site licenses, etc., contact me at the address below. TERMS OF DISTRIBUTION OF ORCHARD HOUSE FOR SOFTWARE LIBRARIES: 1. The fee charged may not exceed $10, including postage, mailer and any other charges. 2. Your library's catalog or listing must state that this program is not free, but is copyrighted software that is provided to allow the user to evaluate it before paying. 3. The offering and sale of Orchard House will be stopped at any time the author so requests. 5. Problems or complaints will be reported to the author for resolution. Please send registrations, comments, complaints, and suggestions to the author: Gleason Pace 12162 S. W. Scholls Ferry Rd. #191 Tigard, Or. 97223 Or you may contact me at my BBS, Noah's Kitchen, 503-977-3934, Fido 1:105/37.